package com.ruoyi.system.mapper;

import java.util.List;
import java.util.Map;
import com.ruoyi.system.domain.SpffSearchHistory;

/**
 * 搜索历史Mapper接口
 * 
 * @author xjj
 * @date 2025-01-28
 */
public interface SpffSearchHistoryMapper 
{
    /**
     * 查询搜索历史
     * 
     * @param id 搜索历史主键
     * @return 搜索历史
     */
    public SpffSearchHistory selectSpffSearchHistoryById(Long id);

    /**
     * 查询搜索历史列表
     * 
     * @param spffSearchHistory 搜索历史
     * @return 搜索历史集合
     */
    public List<SpffSearchHistory> selectSpffSearchHistoryList(SpffSearchHistory spffSearchHistory);

    /**
     * 新增搜索历史
     * 
     * @param spffSearchHistory 搜索历史
     * @return 结果
     */
    public int insertSpffSearchHistory(SpffSearchHistory spffSearchHistory);

    /**
     * 修改搜索历史
     * 
     * @param spffSearchHistory 搜索历史
     * @return 结果
     */
    public int updateSpffSearchHistory(SpffSearchHistory spffSearchHistory);

    /**
     * 删除搜索历史
     * 
     * @param id 搜索历史主键
     * @return 结果
     */
    public int deleteSpffSearchHistoryById(Long id);

    /**
     * 批量删除搜索历史
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteSpffSearchHistoryByIds(Long[] ids);

    /**
     * 获取热门搜索关键词
     * 按搜索频次排序
     * 
     * @param params 参数map：limit
     * @return 热门关键词列表
     */
    public List<Map<String, Object>> getHotSearchKeywords(Map<String, Object> params);

    /**
     * 获取用户搜索历史
     * 按时间倒序
     * 
     * @param params 参数map：userId, limit
     * @return 搜索历史列表
     */
    public List<SpffSearchHistory> getUserSearchHistory(Map<String, Object> params);

    /**
     * 清除用户搜索历史
     * 
     * @param params 参数map：userId, keyword
     * @return 删除记录数
     */
    public int clearUserSearchHistory(Map<String, Object> params);

    /**
     * 检查是否存在相同搜索记录
     * 避免短时间内重复记录
     * 
     * @param params 参数map：userId, keyword, timeLimit
     * @return 记录数
     */
    public int checkDuplicateSearch(Map<String, Object> params);
}

